========================================================
  HOW TO INSTALL A DESKTOP WIDGET ON A MAC
  (and what to do when the Mac refuses to open it)
========================================================

Each "Install ____.command" file installs one widget.
Just double-click the one you want. That's it.

If it installs, you're done - skip the rest of this file.


--------------------------------------------------------
IF THE MAC REFUSES TO OPEN IT
--------------------------------------------------------

You might see a message like:
  - "cannot be opened because it is from an unidentified developer"
  - "Apple could not verify it is free of malware"
  - "you do not have permission to open it"

This is normal. It just means the file has no Apple
certificate - NOT that anything is wrong with it. You
made these files, so they are safe to open.

Use ONE of the two methods below.


--------------------------------------------------------
METHOD 1 - THE EASY CLICK WAY (try this first)
--------------------------------------------------------

1. Double-click the installer. Let it get blocked.
2. Open System Settings (the grey gear icon).
3. Click "Privacy & Security" in the left list.
4. Scroll down to the "Security" section. You'll see a
   line saying the installer "was blocked".
5. Click the "Open Anyway" button next to it.
6. Enter your Mac password / Touch ID if asked.
7. Double-click the installer again - this time click
   "Open" on the pop-up.

It will now install.


--------------------------------------------------------
METHOD 2 - THE BULLET-PROOF WAY (always works)
--------------------------------------------------------

This clears every block in one go. You do NOT type any
file names - you let the Mac fill them in by dragging the
file. Go slowly and do it exactly in this order.


STEP 1 - Open Terminal
......................................................
  - Press and hold the Cmd key, tap the Spacebar, let go.
    A search box appears in the top-right of the screen.
  - Type the word:  terminal
  - Press Enter.
  - A plain window with text in it opens. This is Terminal.
    Leave it open and put it side-by-side with the Finder
    window that has the installer in it, so you can see both.


STEP 2 - The first command
......................................................
  - Click once inside the Terminal window so it is active.
  - Type these 8 characters - the word, a space, a plus,
    an x, and then ONE more space at the very end:

        chmod +x

    (That last space matters. Don't press Enter yet.)

  - Now drag the installer file from the Finder window and
    drop it onto the Terminal window. Let go of the mouse.
    A long path (the file's address) appears by itself.

  - The line should now read something like:
        chmod +x /Users/you/.../Install Gold Spot.command

  - Press Enter. A fresh empty line appears. Good - that
    means it worked. (No message = success in Terminal.)


STEP 3 - The second command
......................................................
  - Type this, again with ONE space at the very end:

        xattr -dr com.apple.quarantine

    (Don't press Enter yet.)

  - Drag the SAME installer file onto the Terminal window
    again, exactly like before. Let go.

  - Press Enter. Another fresh empty line appears.


STEP 4 - Install it
......................................................
  - You can close Terminal now.
  - Go back to Finder and double-click the installer.
  - It opens and installs. Done.


What you just did (in plain English):
  - "chmod +x"  told the Mac it is allowed to run the file.
  - "xattr ..." removed the no-certificate warning.

Tip: if Terminal shows a red "No such file" message, the
space before the dragged-in path was probably missing.
Just type the command again, remember the space, then drag.


--------------------------------------------------------
WHAT THE INSTALLER DOES
--------------------------------------------------------

  - Installs Ubersicht first if you don't have it.
  - Quits Ubersicht, copies the widget in (backing up
    any old copy), then re-opens Ubersicht.
  - The widget appears on your desktop within a few
    seconds.

A fresh install starts blank - re-enter any settings
(e.g. tide key, gold holdings) in the widget's own panel.


--------------------------------------------------------
IF IT STILL WON'T GO
--------------------------------------------------------

  - Make sure you double-clicked the ".command" file,
    not a folder.
  - In Method 2, make sure there is a SPACE before you
    drag the file in, so the path doesn't stick to the
    command.
  - Re-downloading or re-copying the file from iCloud
    re-adds the block, so you may need to redo Method 2.
